Description

This merge request adds lifecycle hooks for bindable container state creation and teardown, so container-specific setup/cleanup can run exactly once per bound state instance rather than on every view appearance.

The problem addressed here is that BindableContainer previously exposed only generic load/unload callbacks tied to the view lifecycle. That makes it hard to distinguish between:

• a new bound reducer/state being created for a container ID, and
• another view instance reusing an already existing bound state.

To solve this, the MR introduces reducer introspection and reference-count checks to detect whether a reducer for a given bindable container ID already exists and whether the current instance is the last one before unload. This allows calling dedicated hooks only when the bound state is first loaded or finally released.

An alternative would have been to move this logic fully into reducer/store internals and emit explicit state lifecycle events, but this implementation keeps the feature localized to bindable containers and existing reducer storage.

Changes Made

• Added new bindable container lifecycle hooks:

  • onBindableContainerStateDidLoad(store:)
  • onBindableContainerStateDidUnload(store:)

• Provided default no-op implementations so existing containers remain source-compatible.

• Wired these new hooks through BindableContainer.connected(...) into ConnectedContainer.

• Introduced AnyBindableReducer to expose runtime metadata and reducer-instance checks:

  protocol AnyBindableReducer: Sendable {
      var boundContainerType: any Any.Type { get }
      func hasReducer(for id: any Hashable) -> Bool
      func isLastInstance(for id: any Hashable) -> Bool
  }

• Made BindableReducer conform to AnyBindableReducer by exposing:

  • the bound container type,
  • whether a reducer exists for a given container ID,
  • whether that reducer is the last referenced instance.

• Extended RCDictionary with uniqueness detection:

  • added isUniquelyReferenced(key:)
  • exposed ReducerBox.referenceCount as private(set) so it can be inspected externally without allowing mutation.

• Updated ConnectedContainer to invoke the new state lifecycle hooks conditionally:

  • call onBindableContainerStateDidLoad only when no reducer exists yet for the container ID,
  • call onBindableContainerStateDidUnload only when the current reducer instance is the last active one.

• Added runtime-based reducer lookup in ConnectedContainer using Runtime.typeInfo to find the matching BindableReducer inside app state by container type.

ClickUp task

https://app.clickup.com/t/869dh0kpx